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Abstract 


This  report  describes  the  application  HalManeuver  for  predicting  maneuvering  of  the 
Canadian  Navy’s  HALIFAX  class.  HalManeuver  was  developed  using  ShipMo3D,  an 
object-oriented  library  for  predicting  ship  motions  in  calm  water  and  in  waves.  Pre¬ 
dicted  maneuvering  motions  are  determined  by  evaluating  forces  acting  on  the  hull, 
rudder,  propeller,  and  other  appendages.  Input  parameters  to  HalManeuver  include 
increments  to  hull  maneuvering  force  coefficients,  which  can  be  adjusted  to  optimize 
agreement  between  observed  and  predicted  maneuvering  properties.  HalManeuver 
demonstrates  the  development  of  an  application  using  the  ShipMo3D  library.  Other 
applications  for  ship  maneuvering  in  both  calm  water  and  in  waves  will  be  developed 
as  requirements  arise. 


Resume 


Dans  ce  rapport,  nous  decrivons  le  logiciel  HalManeuver  de  prediction  des  manoeuvres 
des  navires  canadiens  de  la  classe  Halifax.  On  a  cree  HalManeuver  a  partir  de  Ship- 
Mo3D,  une  bibliotheque  objet  congue  pour  la  prediction  des  mouvements  des  navires, 
sur  une  mer  calme  ou  houleuse.  Les  mouvements  predits  sont  calcules  afin  d’evaluer 
les  forces  exercees  sur  la  carene,  lc  gouvernail,  l’helice  et  les  autres  prolongements  de 
la  coque.  Les  parametres  d’entree  de  HalManeuver  comprennent  des  augmentations 
aux  coefficients  des  forces  exercees  sur  la  carene  par  les  manoeuvres,  qui  peuvent  etre 
ajustees  pour  optimiser  l’accord  entre  les  caracteristiques  observees  et  predites  de 
la  manoeuvre.  En  outre,  la  production  de  HalManeuver  demontre  la  raise  au  point 
d’un  logiciel  a  partir  de  la  bibliotheque  ShipMo3D.  On  elaborera  d’autres  logiciels  de 
simulation  des  manoeuvres  en  mer  calme  ou  houleuse,  en  fonction  des  besoins. 
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Executive  summary 

User  Manual  for  HalManeuver:  A  ShipMo3D  Application 
for  Simulating  HALIFAX  Class  Maneuvering 

Kevin  McTaggart;  DRDC  Atlantic  TM  2005-070;  Defence  R&D  Canada  -  Atlantic; 
January  2006. 

Introduction:  Predictions  of  ship  maneuvering  are  often  required  for  assessment  of 
naval  ship  effectiveness.  To  meet  this  requirement,  Maritime  Forces  Atlantic  (MAR- 
LANT)  Operations  Research  tasked  DRDC  Atlantic  to  develop  an  application  for 
predicting  maneuvering  of  the  Canadian  Navy’s  HALIFAX  class  in  calm  water. 

Principal  Results:  The  program  HalManeuver  has  been  developed  to  simulate  ma¬ 
neuvering  of  the  HALIFAX  class  in  calm  water.  HalManeuver  uses  components  from 
DRDC  Atlantic’s  ShipMo3D  library,  which  has  been  developed  for  simulation  of  ship 
motions  in  calm  water  and  in  waves.  Maneuvering  simulations  using  HalManeuver 
run  approximately  70  times  faster  than  real  time. 

Significance  of  Results:  DND  now  has  an  in-house  capability  for  predicting  ship 
maneuvering.  This  capability  will  advance  as  ongoing  improvements  are  made  to  the 
ShipMo3D  library.  The  high  execution  speed  of  maneuvering  simulations  facilitates 
examining  large  numbers  of  scenarios. 

Future  Plans:  Additional  applications  using  the  ShipMo3D  library  will  be  devel¬ 
oped  as  requirements  arise. 
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User  Manual  for  HalManeuver:  A  ShipMo3D  Application 
for  Simulating  HALIFAX  Class  Maneuvering 

Kevin  McTaggart;  DRDC  Atlantic  TM  2005-070;  R  &  D  pour  la  defense  Canada  - 
Atlantique;  janvier  2006. 

Introduction:  Pour  en  evaluer  l’efficacite,  il  est  souvent  obligatoire  de  predire  les 
manoeuvres  des  batiments  de  guerre.  Pour  satisfaire  a  cet  imperatif,  lc  Detachement 
de  recherche  operationncllc  des  Forces  maritimes  de  1’ Atlantique  FMAR(A)  a  charge 
RDDC  Atlantique  de  la  mise  an  point  d’un  logicicl  de  prediction  des  manoeuvres  en 
eau  calme,  des  navires  de  la  classe  Halifax  de  la  Marine  canadienne. 

Resultats  principaux:  Le  programme  HalManeuver  a  ete  concu  pour  simuler  les 
manoeuvres  d’un  navire  de  la  classe  Halifax  dans  des  eaux  calmes.  Ce  logiciel  com- 
prend  des  elements  tires  de  la  bibliotheque  ShipMo3D  creee  par  RDDC  Atlantique 
pour  simuler  les  mouvements  des  navires  sur  une  mer  calme  ou  houleuse.  Le  calcul 
des  simulations  de  manoeuvres  avec  HalManeuver  est  70  fois  plus  rapide  que  le  temps 
necessaire  pour  les  realiser  avec  un  navire. 

Importance  des  resultats:  Le  MDN  dispose  maintenant  de  son  propre  outil  de 
prediction  des  manoeuvres  de  navires.  Cet  outil  sera  perfectionne  au  fur  et  a  rnesure 
des  ameliorations  qui  seront  apportees  a  la  bibliotheque  ShipMo3D.  La  grande  vitesse 
d’execution  des  simulations  de  manoeuvre  facilitera  l’etude  d’un  nombre  eleve  de 
scenarios. 

Travaux  ulterieurs  prevus:  On  elaborera  d’autres  logiciels,  a  partir  de  la  bi¬ 
bliotheque  ShipMo3D,  en  fonction  des  besoins. 
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1  Introduction 


Predictions  of  ship  maneuvering  are  often  required  for  assessment  of  naval  ship  ef¬ 
fectiveness.  To  meet  this  requirement,  Maritime  Forces  Atlantic  (MARL ANT)  Op¬ 
erations  Research  tasked  DRDC  Atlantic  to  develop  an  application  for  predicting 
maneuvering  of  the  Canadian  Navy’s  HALIFAX  class  in  calm  water.  The  new  ap¬ 
plication  HalManeuver  has  been  developed  using  components  of  DRDC  Atlantic’s 
ShipMo3D  library  for  prediction  of  ship  motions  in  waves. 

ShipMo3D  is  an  object-oriented  library  developed  to  predict  ship  motions  in  both  the 
frequency  and  time  domains.  The  prediction  of  motions  for  a  ship  with  nominally 
steady  speed  and  heading  is  described  in  References  1,  2  and  3.  The  application 
HalManeuver  is  based  on  more  recent  work  in  Reference  4  extending  ShipMo3D  to 
freely  maneuvering  ships  in  waves. 

Section  2  of  this  report  gives  the  axis  system  used  by  HalManeuver.  Section  3  gives 
ship  properties  for  HALIFAX  within  HalManeuver  computations.  User  input  is  de¬ 
scribed  in  Section  4,  followed  by  guidance  on  installing  and  running  HalManeuver 
in  Section  5.  Section  6  describes  program  output,  and  final  conclusions  are  given  in 
Section  7. 

2  Axis  System  for  HalManeuver  Output 


The  program  HalManeuver  computes  ship  motions  in  the  earth  fixed  coordinate  sys¬ 
tem  given  in  Figure  1.  The  coordinates  x\y*  refer  to  the  location  of  the  ship  centre 
of  gravity,  with  x?  being  positive  north  and  yf  being  positive  west.  Both  x*  and  y* 
have  units  of  metres. 

The  ship  heading  \  is  the  direction  toward  which  the  ship  is  pointing.  The  ship 
velocity  can  have  a  different  heading  due  to  the  presence  of  a  non-zero  drift  angle. 

HalManeuver  uses  a  rudder  deflection  convention  of  positive  for  counter-clockwise 
motion  when  looking  down  at  the  rudder;  thus,  a  positive  rudder  deflection  causes 
the  ship  to  turn  to  starboard. 

3  HALIFAX  Properties  with  HalManeuver 


The  application  HalManeuver  is  intended  to  be  easy  to  use;  thus,  representative 
values  for  various  ship  parameters  have  been  selected.  Tables  1  and  2  give  two 
loading  conditions  which  are  available  for  simulation  with  HalManeuver.  The  loading 
condition  in  Table  1  is  a  deep  departure  condition  that  was  used  for  model  tests  with 
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Ship 


Figure  1:  Earth-Fixed  Coordinate  System 

the  CPF  hydroelastic  model  [5].  The  loading  condition  in  Table  2  was  used  for  sea 
trials  with  the  HALIFAX  class. 

To  avoid  using  classified  data,  the  ship  resistance  and  propulsion  characteristics  are 
modelled  using  representative  values  from  the  open  literature.  Table  3  shows  calm 
water  ship  speeds  and  associated  propeller  RPM  values  using  the  modelled  resistance 
and  propulsion  characteristics. 

When  a  command  rudder  angle  is  issued,  the  ship  rudder  responds  according  to  the 
following: 

g rudder  ^ rudder  udder  ^  2  ^  L ^ru^er  ^ 

where  Srudder  is  rudder  deflection  acceleration,  cug  is  the  natural  frequency  for  rudder 
deflection,  fir(ydder  is  the  command  rudder  angle,  Srudder  is  the  actual  rudder  angle,  Q 
is  rudder  response  damping  as  a  fraction  of  critical  damping,  and  Srudder  is  rudder 
deflection  velocity.  Table  4  gives  default  rudder  response  values  used  by  HalManeuver. 

When  simulating  motions  using  HalManeuver,  the  user  can  provide  an  input  com¬ 
mand  rudder  angle  or  can  alternatively  provide  an  input  ship  heading  to  be  used  by 
an  autopilot.  The  autopilot  determines  the  command  rudder  angle  as  follows: 

Srcudder  =  kdx  (X  ~  Xc)  +  Kx  x  (2) 

where  kdx  is  the  yaw  displacement  gain,  xc  is  the  command  ship  heading,  and  kvSx  is 
the  yaw  velocity  gain.  Table  5  gives  the  default  autopilot  gains  for  HalManeuver. 
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Table  1:  Main  Particulars  for  HALIFAX  Class  Frigate,  CPF  Hydroelastic  Model  Deep 
Departure  Condition 


Length,  L 

124.5  m 

Beam,  B 

14.8  m 

Midships  draft,  Tmid 

4.97  m 

Trim  by  stern,  tstern 

-0.04  m 

Displacement,  A 

4601  to 

Vertical  centre  of  gravity,  KG 

6.26  m 

Dry  roll  radius  of  gyration  rxx 

5.82  m 

Dry  pitch  radius  of  gyration  ryy 

28.8  nr 

Dry  yaw  radius  of  gyration  rzz 

28.8  m 

Table  2:  Main  Particulars  for  HALIFAX  Class  Frigate,  Sea  Trial  Deep  Departure 
Condition 


Length,  L 

124.5  m 

Beam,  B 

14.8  m 

Midships  draft,  Tmid 

4.995  m 

Trim  by  stern,  tstern 

0.236  m 

Displacement,  A 

4672  to 

Vertical  centre  of  gravity,  KG 

6.26  m 

Dry  roll  radius  of  gyration  rxx 

5.82  m 

Dry  pitch  radius  of  gyration  ryy 

28.8  m 

Dry  yaw  radius  of  gyration  rzz 

28.8  m 
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Table  3:  Ship  Speeds  in  Calm  Water  and  Associated  Propeller  RPM  for  Unclassified 
Modelling  of  HALIFAX  Maneuvering 


Speed  (knots) 
5 

10 

15 

20 

25 

30 


Propeller  RPM 
28.9 
57.7 

87.1 

121.1 
156.1 
200.6 


Table  4:  Default  Rudder  Control  Properties  for  HALIFAX 


Maximum  rudder  deflection  Sln^er 
Maximum  rudder  velocity  S™axer 
Response  natural  frequency  oug 
Response  damping  Q 


35  degrees 
3  deg/s 
3  rad/s 
0.85 


Table  5:  Default  Autopilot  Gains  for  HALIFAX 

Yaw  displacement  gain  kgx  -4  deg/ deg 

Yaw  velocity  gain  k$x  -8  deg/  (deg/s) 
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Table  6:  Predicted  HALIFAX  Maneuvering  Coefficients  and  Nominal  Uncertainties 


Description 

Symbol 

Predicted 

Uncertainty 

Linear  sway-sway 

Y’ 

V 

-0.207 

±0.05 

Linear  sway-yaw 

Y' 

r 

0.062 

±0.05 

Linear  yaw-sway 

N' 

y  V 

-0.080 

±0.02 

Linear  yaw-yaw 

N'r 

-0.037 

±0.02 

Nonlinear  sway-sway 

Y' 

*v\v\ 

-1.006 

±0.2 

Nonlinear  sway-sway 

Y' 

1v\r\ 

-0.140 

±0.2 

Nonlinear  sway-yaw 

Y' 

r|r| 

0.000 

±0.05 

Nonlinear  yaw- sway 

Kr* 

0.000 

±0.05 

Nonlinear  yaw-yaw 

K\rl 

-0.060 

±0.02 

Nonlinear  yaw-yaw 

KV2 

-0.200 

±0.2 

It  should  be  noted  that  there  is  significant  uncertainty  regarding  hull  maneuvering 
force  coefficients  for  HALIFAX.  HalManeuver  uses  hull  maneuvering  force  coefficients 
predicted  using  the  method  of  Inoue  et  ah  [6]  as  implemented  in  Reference  4.  Table  6 
shows  predicted  maneuvering  coefficients  for  HALIFAX  and  nominal  uncertainties 
associated  with  predicted  maneuvering  coefficients.  A  sensitivity  study  in  Reference  4 
indicates  that  uncertainty  in  the  predicted  linear  yaw-yaw  coefficient  N'r  significantly 
influences  predicted  turning  circle  properties. 

There  is  also  significant  uncertainty  regarding  the  rudder-propeller  interaction  coef¬ 
ficient  Crudder-prop ,  discussed  in  Reference  4.  For  a  single  screw  ship  with  a  large 
rudder  immediately  aft  of  the  propeller,  this  coefficient  will  have  a  value  close  to  its 
limit  of  1.0.  For  a  frigate  like  HALIFAX  with  twin  screws  and  a  single  rudder,  it  is 
more  difficult  to  estimate  the  rudder-propeller  interaction  coefficient.  HalManeuver 
uses  a  default  value  of  0.5  for  the  coefficient  crudder~prop . 


4  User  Input  for  Program  HalManeuver 


HalManeuver  reads  input  from  an  input  file  “halManeuver.inp”  with  a  format  de¬ 
scribed  in  Annex  A.  Annex  B  gives  a  sample  input  file.  Each  line  of  the  input  file 
begins  with  a  descriptive  tag,  and  is  followed  by  character  or  numerical  input. 

The  input  file  starts  with  a  beginning  line  and  a  label  line,  with  the  following  taken 
from  the  sample  input  file  of  Annex  B: 
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begin  halManeuver 

label  Sample  maneuver  for  HALIFAX 

Following  the  above  two  lines,  other  optional  lines  can  be  inserted  to  change  ship 
properties  from  their  default  values. 

The  input  Hie  has  several  lines  for  setting  the  initial  conditions  for  a  simulation,  such 
as  the  following  from  the  sample  input  file: 

dispsFixedOMDeg  0.0  0.0  0.0  0.0  0.0  0.0 
velsFixedOMDeg  10.3  0.0  0.0  0.0  0.0  0.0 
rudderDef lectODeg  0.0 
rudderVelODeg  0.0 
rpmsPropellersO  130.0  130.0 
rpmVelsPropellersO  0.0  0.0 

Ship  initial  displacements  and  velocities  for  all  6  degrees  of  freedom  are  given  in  the 
records  beginning  with  “dispsFixedOMDeg”  and  “velsFixedOMDeg”.  Initial  condi¬ 
tions  are  also  given  for  the  single  rudder  and  twin  propellers. 

Following  the  initial  conditions,  commands  are  given  for  setting  the  rudder  and  pro¬ 
peller  and  for  executing  maneuvers.  For  example,  the  following  commands  set  the 
propeller  RPMs  according  to  a  calm  water  speed  of  20  knots,  set  the  rudder  to  30 
degrees  (for  starboard  turn),  and  tell  the  simulation  to  advance  until  the  ship  reaches 
a  heading  of  90  degrees  (i.e. ,  heading  east). 


setSpeedCalm  20.0 
setRudder  30 . 0 
turnAbsHeading  90 . 0 


All  maneuver  commands,  such  as  turnAbsHeading,  have  a  default  time  limit  of  3600 
s  (one  hour),  which  can  be  over-ridden  by  user  input.  The  next  two  lines  of  sample 
input  tell  the  ship  to  switch  to  autopilot  for  a  course  of  120  degrees  and  to  travel  a 
distance  of  1000  m: 

setCourse  120.0 
straightDistance  1000.0 

The  input  file  ends  with  the  following: 

end  halManeuver 
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5  Installing  and  Running  Program 
HalManeuver 


The  program  HalManeuver  has  been  compiled  to  an  executable  file  “HalManeu¬ 
ver. exe”.  The  directory  with  “HalManuever.exe”  must  also  include  the  following 
dynamically  linked  libraries: 

•  _dotblas.pyd 

•  _numpy.pyd 

•  dislin.dll 

•  lapackJite.pyd 

•  multiarray.pyd 

•  python24.dll 

•  ranlib.pyd 

•  umath.pyd 

Program  HalManeuver  reads  input  from  file  “halManeuver.inp”  and  writes  output  to 
file  “halManeuver.out”.  The  following  files  with  data  for  HALIFAX  must  also  be  in 
the  run  directory: 

•  cpfHydroFreeShipTD.pkl 

•  cpfManTrialFreeShipTD.pkl 

Using  the  default  time  step  size  of  0.5  s,  HalManeuver  runs  approximately  70  times 
faster  than  real  time  on  a  PC  with  a  1800  MHz  Pentium  4  processor  running  Windows 
XP  Professional. 

6  Output  from  Program  HalManeuver 


Annex  C  gives  sample  output  from  program  HalManeuver.  The  output  begins  with 
user  input  and  default  parameters  for  the  simulation.  The  output  then  gives  a  log  of 
start  times  for  execution  of  maneuvering  commands.  The  final  portion  of  the  output 
is  a  time  series  of  motions,  rudder  deflection,  and  propeller  RPMs.  Only  horizontal 
plane  motions  are  currently  given  in  the  output. 
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Figure  2  gives  the  trajectory  from  the  sample  output  hie.  From  its  initial  trajectory 
heading  north,  the  ship  makes  a  90  degree  turn  to  the  east.  Upon  completion  of  the 
initial  turn,  the  ship  travels  a  distance  of  1200  m  with  an  autopilot  heading  of  120 
degrees. 


Figure  2:  Trajectory  for  Sample  Output 


7  Conclusions 


The  ShipMo3D  application  HalManeuver  has  been  developed  to  provide  maneuvering 
predictions  for  the  Canadian  Navy’s  HALIFAX  class.  The  applications  reads  user 
input  commands  for  ship  maneuvering  and  produces  output  of  times  series  for  ship 
motions. 

HalManeuver  demonstrates  the  development  of  an  application  using  the  ShipMo3D 
library.  Other  applications  for  ship  maneuvering  in  both  calm  water  and  in  waves 
will  be  developed  as  requirements  arise. 
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Symbols  and  Abbreviations 


B 

(jr  udder —prop 


KG 

hd 

KSX 

hv 

KSX 

L 

K 

Nr\r\ 


Kv* 


N' 

1  V 

N'  2 

vrz 

T  XX 

ryy 
r 


ZZ 


mid 


T, 

t  stern 

xf,yf 

y; 

nVi 


Y’ 

V 

Y' 

1v\r\ 


Y' 

Iv\v\ 


£ rudder 

Zrudder 

°C 

s:rudder 
v max 
krudder 
umax 

Cs 

x 

Xc 

LUS 

A 


beam 

rudder-propeller  interaction  coefficient 

vertical  centre  of  gravity  relative  to  baseline 

rudder  heading  displacement  gain 

rudder  heading  velocity  gain 

ship  length  between  perpendiculars 

linear  yaw-yaw  maneuvering  force  coefficient 

yaw  velocity  dependent  nonlinear  yaw-yaw  maneuvering 

force  coefficient 

sway  velocity  dependent  nonlinear  yaw-yaw  maneuvering 
force  coefficient 

linear  yaw-sway  maneuvering  force  coefficient 

yaw  velocity  dependent  nonlinear  yaw-sway  maneuvering 

force  coefficient 

roll  radius  of  gyration 

pitch  radius  of  gyration 

yaw  radius  of  gyration 

draft  at  midships 

trim  by  stern 

horizontal  plane  coordinates  in  earth-fixed  coordinate  system 
linear  sway-yaw  maneuvering  force  coefficient 
yaw  velocity  dependent  nonlinear  sway-yaw  maneuvering 
force  coefficient 

linear  sway-sway  maneuvering  force  coefficient 

yaw  velocity  dependent  nonlinear  sway-sway  maneuvering 

force  coefficient 

sway  velocity  dependent  nonlinear  sway-sway  maneuvering 

force  coefficient 

rudder  deflection  angle 

command  rudder  angle 

maximum  rudder  deflection 

maximum  rudder  velocity 

rudder  nondimensional  damping  response  constant 
ship  heading  (to)  in  earth-fixed  axes 
command  ship  heading  (to)  in  earth-fixed  axes 
rudder  response  natural  frequency 
displacement 
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Annex  A:  Input  File  Format  for  Application 
HalManeuver 

Detailed  descriptions  of  HalManeuver  input  records  are  given  below.  Each  new  input 
record  or  sub-record  corresponds  to  a  new  file  line.  Input  records  must  be  given  in  the 
order  specified  below,  although  optional  records  can  be  omitted.  Each  input  record 
begins  with  a  specified  record  tag. 

The  format  of  the  input  hie  may  be  adjusted  by  inserting  extra  blanks  between  any 
numerical  or  character  string  data.  Each  input  record  must  be  confined  to  a  single 
hie  line. 

Record  (a),  Beginning  Record 

“begin  halManeuver”  (1  character  string  with  2  words) 

Record  (b),  Run  Title 

“label” ,  title  (2  character  strings) 

“label”  Record  tag. 

title  Title  for  run.  This  can  include  spaces. 

Record  (c),  Record  (c),  Plot  Option 

This  record  is  optional. 

“plotOption” ,  plotOption  (2  character  strings) 

“plotOption”  Record  tag. 

plotOption  Set  to  “plot”  for  plotting,  or  “noPlot”  for  no  plotting.  If  plotting 
is  requested,  then  plots  of  ship  motions  are  displayed  on  the 
screen  at  the  end  of  the  run. 

Note:  If  this  record  is  omitted,  then  no  plotting  is  done. 
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Record  (d),  Draft  and  Trim 

This  record  is  optional. 

“draft Trim”,  draftBIMid,  trimBIStern  (1  character  string,  2  floats) 

“draft Trim”  Record  tag. 

draftBIMid  Ship  draft  at  midships  (m). 

trimBIStern  Trim  by  stern  (m). 

Note:  If  this  record  is  omitted,  then  the  draft  and  trim  are  set  to  default 

values  of  4.970  m  and  -0.040  m  respectively.  If  this  record  is 
included,  then  the  draft  and  trim  must  be  set  to  a  valid 
combination.  Current  valid  combinations  are. 

•  Draft  of  4.970  m  and  trim  of  -0.040  m, 

•  Draft  of  4.995  m  and  trim  of  0.236  m. 

Record  (e),  Increments  to  Default  Maneuvering  Coefficients 

This  record  is  optional. 

“deltaManCos” ,  deltaYv,  deltaYr,  deltaNv,  deltaNr,  deltaYvv,  deltaYvr, 
deltaYrr,  deltaNvr2,  dcltaNrr,  deltaNrv2  (1  character  string,  10  floats) 

“deltaManCos”  Record  tag. 

deltaYv  Increment  to  sway-sway  maneuvering  force  coefficient  Y'v. 

deltaYr  Increment  to  sway- yaw  maneuvering  force  coefficient  Y'r. 

deltaNv  Increment  to  yaw-sway  maneuvering  force  coefficient  N'v. 

deltaNr  Increment  to  sway-sway  maneuvering  force  coefficient  N'r,. 

deltaYvv  Increment  to  nonlinear  maneuvering  force  coefficient  Y',\v\ ■ 

deltaYvr  Increment  to  nonlinear  maneuvering  force  coefficient  Y^. 

deltaYrr  Increment  to  nonlinear  maneuvering  force  coefficient  YY . 

dcltaNvr2  Increment  to  nonlinear  maneuvering  force  coefficient  N'  2. 

dcltaNrr  Increment  to  nonlinear  maneuvering  force  coefficient  IV'|r|. 

dcltaNrv2  Increment  to  nonlinear  maneuvering  force  coefficient  N'  2. 

Note:  If  this  record  is  omitted,  then  all  of  the  above  values  are  set  to 

0.0. 
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Record  (f),  Rudder  Response  Properties 

This  record  is  optional. 

“rudderProperties” ,  deflectMaxDeg,  velMaxDeg,  freqResponse, 
dampResponse,  rudderPropCo  (1  character  string,  5  floats) 

“rudderProperties”  Record  tag. 

deflectMaxDeg  Maximum  rudder  deflection  angle  (degrees)  (default  35.0). 
velMaxDeg  Maximum  rudder  deflection  velocity  (degrees/s)  (default 

3.0). 

freqResponse  Rudder  natural  response  frequency  (rad/s)  (default  3.0). 

dampResponse  Rudder  response  damping  ratio  as  fraction  of  critical 

damping  (default  0.85). 

rudderPropCo  Rudder-propeller  interaction  coefficient  (default  0.5). 

Record  (g),  Auto  Pilot  Yaw  Gains 

This  record  is  optional. 

“autoPilotGains”,  headingGain,  heading  VelGain  (1  character  string,  2 
floats) 

“autoPilotGains”  Record  tag. 

headingGain  Autopilot  heading  gain  (deg/deg)  (default  -4.0).  This  value 

should  be  less  than  zero  for  ffALIFAX,  which  has  its  rudder 
pointing  downward. 

headingVelGain  Autopilot  heading  velocity  gain  (deg/ (deg/s))  (default  -8.0). 

This  value  should  be  less  than  or  equal  to  zero  for  ffALIFAX, 
which  has  its  rudder  pointing  downward. 

Record  (h),  Time  Step  Size 

This  record  is  optional. 

“dtMax”,  dtMax  (1  character  string,  1  float) 

“dtMax”  Record  tag. 

dtMax  Time  step  size  (default  0.5  s)  for  motion  computations.  This  value 
should  be  <  2  seconds. 

Record  (i),  Start  Time 

“tO”,  tO  (1  character  string,  1  float) 

“tO”  Record  tag. 
tO  Simulation  start  time  (s). 
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Record  (j),  Initial  Ship  Position 

“dispsFixedOMDeg” ,  dispsFixedOMDeg[6]  (1  character  string,  6  floats) 
“dispsFixedOMDeg”  Record  tag. 
dispsFixedOMDeg [0]  Initial  ad  position  (m,  +  north). 
dispsFixedOMDeg [1]  Initial  yf  position  (m,  +  west). 

dispsFixedOMDeg [2]  Initial  heave  relative  to  value  in  calm  water  (m,  +  up). 

dispsFixedOMDeg [3]  Initial  roll  relative  to  value  in  calm  water  (deg,  +  port 

up). 

dispsFixedOMDeg [4]  Initial  pitch  r/g  relative  to  value  in  calm  water  (deg,  +  bow 

down) . 

dispsFixedOMDeg [5]  Initial  heading  y  (deg,  +  clockwise,  0°  for  north). 

Record  (k),  Initial  Ship  Velocity 

“velsFixedOMDeg”,  velsFixedOMDeg[6]  (1  character  string,  6  floats) 
“velsFixedOMDeg”  Record  tag. 

velsFixed0MDeg[0]  Initial  velocity  id  (m/s,  +  north). 
velsFixedOMDeg[l]  Initial  velocity  y*  (m/s,  +  west). 
velsFixedOMDeg[2]  Initial  heave  velocity  f][  (m/s,  +  up). 
velsFixedOMDeg[3]  Initial  roll  velocity  f){  (deg/s,  +  port  up). 
velsFixedOMDeg[4]  Initial  pitch  velocity  f/g  relative  to  value  in  calm  water 

(deg/s,  +  bow  down). 

velsFixedOMDeg[5]  Initial  heading  velocity  x  (deg/s,  +  clockwise). 

Record  (1),  Initial  Rudder  Deflection 

“rudderDeflectODeg” ,  rudderDeflectODeg  (1  character  string,  1  float) 
“rudderDeflectODeg”  Record  tag. 

rudderDeflectODeg  Initial  rudder  deflection  (deg,  +  counter-clockwise  viewed 

from  above). 

Record  (m),  Initial  Rudder  Velocity 

“rudderVelODeg” ,  rudder VelODeg  (1  character  string,  1  float) 

”  rudder VelODeg”  Record  tag. 

rudderVelODeg  Initial  rudder  deflection  velocity  (deg/s,  +  counter-clockwise 
viewed  from  above). 
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Record  (n),  Initial  Propeller  Velocities 

“rpmsPropulsorsO” ,  rpmsPropulsorsO  [2]  (1  character  string,  2  floats) 
“rpmsPropellersO”  Record  tag. 

rpmsPropellersO/)]  Initial  RPM  of  port  propeller  (RPM). 
rpmsPropellersO [1]  Initial  RPM  of  starboard  propeller  (RPM). 

Record  (o),  Initial  Rate  of  Change  of  Propeller  Velocities 

“rpmVelsPropellersO” ,  rpmVelsPropcllersO[2]  (1  character  string,  2  floats) 
“rpmVelsPropellersO”  Record  tag. 

rpmVelsPropellersO  [0]  Initial  rate  of  change  of  RPM  of  port  propeller  (RPM/s). 
rpmVelsPropellersO  [1]  Initial  rate  of  change  of  RPM  of  starboard  propeller 

(RPM/s). 

Records  (pi)  to  (p8)  given  below  can  be  given  in  any  sequence  and  can  be  repeated. 
For  many  maneuver  commands,  the  input  variable  tElapsedMax  is  optional  and  will 
have  a  default  of  3600  s  if  not  included. 

Record  (pi),  Propeller  RPM  Command 

This  record  is  optional. 

“setRpm”,  indexPropeller,  rpmCommand  (1  character  string,  2  floats) 

’’setRpm”  Record  tag. 

indexPropeller  Index  for  propeller  (0  for  port  propeller,  1  for  starboard 
propeller,  <  —  1  for  both  propellers). 
rpmCommand  Command  propeller  RPM  (RPM). 

Record  (p2),  Speed  Command 

This  record  is  optional. 

“setSpeedCalm” ,  speedKnots  (1  character  string,  1  float) 

“setSpeedCalm”  Record  tag. 

speedKnots  Ship  speed  in  calm  water  (knots)  for  which  RPM  of  both 

propellers  are  set. 

Record  (p3),  Course  Command 

This  record  is  optional. 

“setCourse”,  shipHeadingToCommandDeg  (1  character  string,  1  float) 
“setCourse”  Record  tag. 

shipHeadingToCommandDeg  Ship  heading  x  (deg)  to  which  autopilot  is  set. 
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Record  (p4),  Rudder  Deflection  Command 

This  record  is  optional. 

“setRudder”,  deflect CommandDeg  (1  character  string,  1  float) 

“setRudder”  Record  tag. 

deflect  CommandDeg  Command  rudder  deflection  angle  (deg,  + 

counter-clockwise  viewed  from  above).  A  positive  rudder 
deflection  turns  the  ship  to  starboard. 


Record  (p5),  Turn  to  Absolute  Heading  Maneuver  Command 

This  record  is  optional. 

“turnAbsHeading” ,  finalHeadingDeg,  tElapsedMax  (optional)  (1  character 
string,  1  or  2  floats) 

“turnAbsHeading”  Record  tag. 

finalHeadingDeg  Ship  heading  x  (deg,  0  for  north)  at  which  the  program 

considers  the  command  completed.  To  ensure  completion  of 
a  turn,  a  setRudder  command  should  normally  be  made 
before  a  turnAbsHeading  command. 

tElapsedMax  Time  limit  (s)  for  attempting  to  reach  heading 

finalHeadingDeg.  If  this  input  is  not  included,  then  a  default 
value  of  3600  s  is  used. 


Record  (p6),  Turn  Change  in  Heading  Maneuver  Command 

This  record  is  optional. 

“turnDeltaHeading” ,  deltaHeadingDeg,  tElapsedMax  (optional)  (1 
character  string,  1  or  2  floats) 

“turnDeltaHeading”  Record  tag. 


deltaHeadingDeg 


tElapsedMax 


Change  from  initial  heading  at  which  the  program 
considers  the  turn  maneuver  completed.  To  ensure 
completion  of  a  turn,  a  setRudder  command  should 
normally  be  made  before  a  turnDeltaHeading  command, 
with  the  command  rudder  angle  deflect  CommandDeg 
having  a  sign  opposite  to  that  of  deltaHeadingDeg. 

Time  limit  (s)  for  attempting  to  reach  change  in  heading 
deltaHeadingDeg.  If  this  input  is  not  included,  then  a 
default  value  of  3600  s  is  used. 
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Record  (p7),  Straight  Distance  Maneuver  Command 

This  record  is  optional. 

“straightDistance” ,  distance,  tElapsedMax  (optional)  (1  character  string,  1 
or  2  floats) 

“straightDistance”  Record  tag. 

distance  Straight  line  distance  (m)  between  start  and  end  points  at 

which  the  program  considers  the  maneuver  completed. 

tElapsedMax  Time  limit  (s)  for  attempting  to  traverse  distance 

straightDistance.  If  this  input  is  not  included,  then  a  default 
value  of  3600  s  is  used. 

Record  (p8),  Elapsed  Time  Maneuver  Command 

This  record  is  optional. 

“elapsedTime” ,  tElapsedMax  (1  character  string,  1  float) 

“clapsedTime”  Record  tag. 

tElapsedMax  Elapsed  time  at  which  the  program  considers  the  maneuver 
completed. 

Record  (q),  End  Record 

“end  halManeuver”  (1  character  string  with  2  words) 
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Annex  B:  Sample  HalManeuver  Input  File 


begin  halManeuver 

label  Sample  maneuver  for  HALIFAX 
dispsFixedOMDeg  0.0  0.0  0.0  0.0  0.0  0.0 
velsFixedOMDeg  10.3  0.0  0.0  0.0  0.0  0.0 
rudderDef lectODeg  0.0 
rudderVelODeg  0.0 
rpmsPropellersO  130.0  130.0 
rpmVelsPropellersO  0.0  0.0 
setSpeedCalm  20.0 
setRudder  30.0 
turnAbsHeading  90 . 0 
setCourse  120.0 
straightDistance  1000.0 
end  halManeuver 
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Annex  C:  Sample  HalManeuver  Output  File 
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3.00  31.0  0.0  0.2  10.311  0.042  0.202  7.60  121.1  121 
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34.00  318.1  -72.1  39.4  7.515  -5.761  1.390  30.00  121.1  121 
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ing  ShipMo3D,  an  object-oriented  library  for  predicting  ship  motions  in  calm 
water  and  in  waves.  Predicted  maneuvering  motions  are  determined  by  eval¬ 
uating  forces  acting  on  the  hull,  rudder,  propeller,  and  other  appendages. 
Input  parameters  to  HalManeuver  include  increments  to  hull  maneuvering 
force  coefficients,  which  can  be  adjusted  to  optimize  agreement  between  ob¬ 
served  and  predicted  maneuvering  properties.  HalManeuver  demonstrates 
the  development  of  an  application  using  the  ShipMo3D  library.  Other  applica¬ 
tions  for  ship  maneuvering  in  both  calm  water  and  in  waves  will  be  developed 
as  requirements  arise. 


14.  KEYWORDS,  DESCRIPTORS  or  IDENTIFIERS  (technically  meaningful  terms  or  short  phrases 
that  characterize  a  document  and  could  be  helpful  in  cataloguing  the  document.  They  should  be  selected 
so  that  no  security  classification  is  required.  Identifiers,  such  as  equipment  model  designation,  trade 
name,  military  project  code  name,  geographic  location  may  also  be  included.  If  possible  keywords  should 
be  selected  from  a  published  thesaurus,  e.g.  Thesaurus  of  Engineering  and  Scientific  Terms  (TEST) 
and  that  thesaurus-identified.  If  it  not  possible  to  select  indexing  terms  which  are  Unclassified,  the 
classification  of  each  should  be  indicated  as  with  the  title). 
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